All Questions
Tagged with documentationagile
20 questions
1vote
2answers
1kviews
How to structure the project documentation?
I just started our bachelor thesis, and want to ask you how to make a proper documentation. There are two pieces of software in our project's scope: a microcontroller software (node), and a server ...
1vote
2answers
374views
When is documentation, unit testing, QA and refactoring meant to be done in a 2 week agile sprint?
The team I am working on is trying to do agile development with 2 week sprints. I think we must be doing something wrong however, as we have to work like madmen to get the features implemented in the ...
2votes
2answers
844views
Agile Scrum - Importance of requirement gathering and documentation and suggestions to improve
We are using agile scrum methodologies for developing and maintaining a product. Since we are a product company, we do not work with customer directly on day to day basis, but instead communicate with ...
1vote
1answer
808views
As an lone, Agile (PXP/PSP) developer what is the proper structure for a formal project post-mortem? [closed]
Question: As an lone, Agile (PXP/PSP) developer what is the proper structure for a formal project post-mortem? Scenario I'm using a PXP methodology (which is a blend of extreme programming and the ...
3votes
2answers
323views
How do you validate need for documentation?
I once was on a project where a non-tech manager had the team spending half of every hour documenting what they just did so that someone with zero understanding of the tech would be able to understand ...
27votes
5answers
45kviews
Design documents as part of Agile
At my workplace, we face a challenge in that "agile" too often has meant "vague requirements, bad acceptance criteria, good luck!" We're trying to address that, as a general improvement effort. So, ...
4votes
3answers
2kviews
Extreme Programming - documenting implementation?
In extreme programming methodology, what artifacts/ can be used to document the implementation? I have used an activity diagram to document the design steps for each activity. I have read that for XP,...
13votes
7answers
2kviews
Documentation degrading - how to deal with it?
Important: we have no issues whatsoever with source code documentation. This belongs to regular code audit and is kept up to date. Our problem is with developers documentation (or, "external" if you ...
6votes
5answers
8kviews
How to properly document functionality in an agile project?
So recently, we've just finished the first phase of our project. We used agile with fortnightly sprints. And whilst the application turned out well, we're now turning our eyes on some of the ...
8votes
6answers
908views
How to use unit tests as a source of information?
A colleague of mine was once at a seminar about agile development, where he heard it is possible to use unit tests as technical documentation. Something like using unit tests as an example of how to ...
15votes
7answers
3kviews
How can Scrum be adapted to an academic environment?
I'm currently working with a professor at my university to develop new curricula for the Software Engineering and Capstone Design courses offered in my college. Up until recently, both courses used ...
6votes
1answer
231views
How to change documentation expectations from "risk management" to a "project risk"
We are trying to introduce some agile concepts to the business folks but one of our biggest hurdles is their expectations for documentation - the quantity, the authorship/ownership of the documents, ...
6votes
2answers
334views
How do you track existing requirements over time?
I'm a software engineer working on a complex, ongoing website. It has a lot of moving parts and a small team of UI designers and business folks adding new features and tweaking old ones. Over the last ...
11votes
5answers
7kviews
Is it a good idea to write requirements specifications by stories?
We're using agile methods in my current project at the moment, and we have heaps of stories like these: As an assistant, I want to pay a customer a refund so that they can get some money when they ...
6votes
5answers
23kviews
Are High Level Design and Low Level Design documents needed to follow Agile development process?
Our team is developing a project using an Agile development process. All of our requirements are converted into product backlog items and task are broken down based on that. One of my team member ...